Skip to content

VitePress 配置教程

本教程基于 VitePress 官方文档,用大白话带你一步步完成配置。已经帮你搭好了基础框架,你只需要改内容即可。

你需要准备什么

  • 一台装了 Node.js 20+ 的电脑
  • 一个能写 Markdown 的编辑器(推荐 VS Code 或 Obsidian)
  • 会基本的 Markdown 语法

教程目录

章节内容
快速开始安装、初始化、文件结构和启动
顶栏和侧边栏导航栏配置、侧边栏配置、多侧边栏
主题配置颜色、字体、暗黑模式、搜索框、页脚
Markdown 功能扩展语法、代码高亮、自定义容器
资源处理图片引用、public 目录、base 路径
使用 Vue在 Markdown 中写 Vue 组件和模板
部署上线构建站点、部署到 GitHub Pages
高级功能站点地图、MPA 模式、数据加载

这个站点本身就是一个示例

你在看的这个站点就是用 VitePress 搭的。配置文件和所有页面都在 src/ 目录下,可以直接翻看源码学习。

Powered by VitePress